home *** CD-ROM | disk | FTP | other *** search
/ Power CD / Power CD ATARI-Rechner Lieben.iso / DEMOS / COLUMBUS / ERGODEMO / 10_STEPS.TXT next >
Encoding:
Text File  |  1994-04-27  |  13.9 KB  |  266 lines
  1. ==========================================================================
  2.  
  3.                     ERGO!-PRO  IN  10  SCHRITTEN
  4.  
  5.           Ein Schnellkurs zur Demo-Version von ergo!-pro
  6.  
  7. ==========================================================================
  8. Willkommen beim ergo!-pro Schnellkurs! Drucken Sie diese Datei am besten 
  9. aus und legen sie neben ihren Computer. Mit dieser Anleitung lernen Sie 
  10. in 10 Schritten die wichtigsten Möglichkeiten von ergo!-pro kennen.
  11.  
  12. Haben Sie ERGO!pro korrekt installiert, wie es in der Datei ERGODEMO.TXT
  13. beschrieben ist? Dann frisch ans Werk! 
  14.  
  15.  
  16. 1. ergo! starten und einrichten
  17. -------------------------------
  18. Mit Doppelklick auf ERGODEMO.APP geht es los. Da Sie sich nun in der Shell
  19. befinden, müssen hier zunächst einmal die Programme des GFA-Entwicklungs-
  20. systems angemeldet werden:
  21. Rufen Sie dazu den Menüpunkt 'Parameter -- GFA-BASIC-Sets' auf. Wie Sie hier 
  22. sehen, sind die vier leeren Felder mit den passenden Dateinamen zu belegen. 
  23. Mit einem DOPPELKLICK auf ein Feld rufen Sie die Dateiauswahlbox auf. Wenn 
  24. die Felder belegt sind, sollten Sie oben noch einen Namen für das 'Set' 
  25. eintragen, schreiben Sie zunächst einfach mal GFA dahin.
  26. Nach Beenden des Dialogs sehen Sie, daß im Projektfenster dieser Name unten 
  27. sichtbar ist. 
  28. Wichtig sind diese Sets (und ihre Namen) dann, wenn Sie verschiedene 
  29. Interpreter, Compiler oder Libraries verwenden (3.5 und 3.6, gepatchte und 
  30. ungepatchte,...). Diese müssen nur einmal eingestellt werden und können dann 
  31. im Projektfenster über das Popup direkt abgerufen werden.
  32. Mit 'Parameter -- Parameter sichern' tragen Sie den Stand der Dinge 
  33. in die INF-Datei ein, und können nach dem nächsten Programmstart an dieser
  34. Stelle weitermachen.
  35.  
  36.  
  37. 2. GFA-Datei wählen
  38. -------------------
  39. Suchen Sie nun über 'Datei -- Öffne GFA...' eine GFA-Datei aus. Diese 
  40. wird automatisch in das erste Feld des Projekt-Fensters eingetragen. 
  41. Darunter ist der Name der übersetzten Programmdatei zu sehen. Natürlich 
  42. muß er nicht so übernommen werden, sondern kann nach Belieben abgeändert 
  43. werden. Doppelklick auf den Eintrag genügt!
  44.  
  45.  
  46. 3. GFA-Datei bearbeiten und übersetzen
  47. --------------------------------------
  48. Über 'Programme -- GFA-Basic' rufen Sie nun den Interpreter auf, wobei 
  49. die gewählte GFA-Datei automatisch mit geladen wird. So können Sie 
  50. gleich mit der Bearbeitung Ihres Programmes beginnen. Noch schneller 
  51. kommen Sie übrigens mit der Taste 'G' oder einem Einfachklick auf den 
  52. GFA-Dateinamen (im Projektfenster) in den Interpreter. 
  53. Wollen Sie nun ihr Programm übersetzen und binden, so rufen Sie einfach
  54. 'Datei -- Erstellen' auf (oder die Taste '^M' für MAKE) und schon werden
  55. Compiler und Linker des GFA-Entwicklungssystens aufgerufen. Wie Sie sehen,
  56. erfolgen die Ausgaben im Fenster und am Ende des Vorgangs wird eine
  57. Projektinformation ausgegeben. So haben Sie immer Kontrolle über die 
  58. Vorgänge und können auch die Fehlermeldungen des Compilers im Ausgabefenster 
  59. der Shell in Ruhe ansehen.
  60. Die Einstellung der Compiler- und Linkeroptionen wird im 'Parameter'-Menü
  61. aufgerufen. Wenn Sie zu diesen Dialogen irgendwelche Fragen haben...kein 
  62. Problem: Überall gibt's Hilfe:
  63.  
  64.  
  65. 4. HILFE!!
  66. ----------
  67. Hilfen gibt's in ERGO!pro an allen Ecken und Enden. Zunächst sehen Sie den 
  68. Menüpunkt 'Hilfe' mit seinen Unterthemen. Hier werden die wichtigsten 
  69. Dinge zur Bedienung und Funktion der Shell und zur Arbeitsweise von ERGO!pro 
  70. kurz erläutert. Auch zu allen Menüpunkten findet man eine Erklärung.
  71. Doch damit nicht genug: Auch innerhalb aller Dialoge findet man Hilfen.
  72. Neben einem allgemeinen Hilfstext, der mit HELP (Taste oder Button) 
  73. aufgerufen wird, ist zu jedem Text innerhalb der Dialoge eine spezielle 
  74. Hilfe vorhanden. Diese erscheint, wenn man den Text mit gedrückter Shift-
  75. Taste anklickt. 
  76.  
  77.  
  78. 5. Noch mehr Hilfe .. das ACC
  79. -----------------------------
  80. Neben diesen Hilfen, die ja nur ERGO!pro selbst betreffen, werden auch 
  81. alle Fragen zu GFA-Basic beantwortet: Rufen Sie dazu einfach das ACC 
  82. auf. Hier finden sich weitere Erläuterungen zur Bedienung. Der Clou 
  83. dabei ist die Kommunikation mit dem Interpreter, die in beide Richtungen 
  84. funktioniert. Lassen Sie sich dieses Bonbon nicht entgehen!! Mehr 
  85. Hinweise dazu gibt es im Accessory selbst. 
  86. Übrigens: Sollten Sie bei der Anzeige der Hilfsgraphik zum Thema 'String-
  87. feld-Organisation' Pixelmüll am oberen Bildschirmrand bekommen, so liegt
  88. das an der Unart des GFA-Interpreters, nur 16kB für das System und für 
  89. ACCs freizulassen. Selbstverständlich gibt es dafür eine Lösung. Diese
  90. wird in Form des GFA_PATCH-Programms auf der ergo!-pro-Diskette mitgelie-
  91. fert.
  92.  
  93. Nachdem nun ergo!-pro als Entwicklungs-Shell und kontext-sensitives Online-
  94. Hilfssystem vorgestellt wurde, kommen nun weitere Highlights, nämlich die
  95. Analyse- und Bearbeitungsfunktionen:
  96.  
  97.  
  98. 6. Die Analyse:
  99. ---------------
  100. Mit 'Bearbeiten -- XREF-Analyse' starten Sie die Analyse ihres Programmes.
  101. Die Demo-Version analysiert beliebig große Programme, jedoch läuft sie 
  102. sehr gebremst ab. 
  103. Nach Ende der Analyse sehen Sie nun, daß der Button [ XRB ] im 
  104. Projektfenster schwarz statt grau ist. Das zeigt Ihnen, daß eine 
  105. Analysedatei angelegt worden ist. ergo!-pro bietet nun vielfältige 
  106. Möglichkeiten, diese Analyse für Sie auszuwerten und auszugeben. Wir 
  107. wollen hier nur drei davon durchführen: 
  108.  
  109. a) Mit 'Ausgabe -- Baumdiagramm' erhalten Sie ein komplettes 
  110.    Strukturdiagramm zu Ihrem Programm. Wenn Sie im Ausgabedialog auf 
  111.    'Drucker' schalten, so sollten Sie vorher eine passende Drucker-
  112.    anpassungsdatei in das betreffende Feld dieses Dialogs eintragen
  113.    (da die Dateien so ähnlich wie die Drucker heißen, dürften Sie schon 
  114.    die richtige finden).
  115.    
  116. b) Mit 'Ausgabe -- XRef-Analyse' wird ein großer Dialog aufgerufen. 
  117.    Stellen Sie hier 'Hilfstexte' an, 'Unterprogramme auflisten' aus.
  118.    Dann wählen Sie bei 'Analyse' den Punkt 'alle Variablen & Prozeduren',
  119.    womit eine vollständige Ausgabe der Crossreferenzinformationen  
  120.    erfolgt. Stellen Sie zusätzlich 'Verweise mit Prozedurennamen' ein.
  121.    Da diese Liste evt. sehr lang werden könnte, lenken Sie die Ausgabe
  122.    zunächst besser in das Fenster.
  123.  
  124.    Eine kompaktere Ausgabe, die zum Ausdrucken evt. eher geeignet ist,
  125.    erhalten Sie über die Einstellung 'Verweise mit Prozedurnummern'.
  126.    Damit Sie die Nummern richtig 'lesen' können, müssen dazu aber auch 
  127.    'Unterprogramme auflisten' ankreuzen. Dies liefert eine chronologisch
  128.    numerierte Liste aller Unterprogramme.
  129.  
  130.    Mit dieser Liste haben Sie eine komplette und verläßliche Übersicht
  131.    darüber, welche Variable wo und wie verwendet wird, welche Prozedur 
  132.    wo und wieoft aufgerufen wird. Dies kann eine enorme Hilfe beim 
  133.    Bearbeiten mittlerer und größerer Programme sein. Umständliches 
  134.    Umhersuchen im Quelltext entfällt damit.
  135.    Noch nützlicher ist allerdings die Diagnose:
  136.  
  137. c) Stellen Sie im gerade besprochenen Dialog im Feld 'Analyse' den Punkt
  138.    'fehlerhafte Verwendungen' ein. Außerdem sollte 'Fehlermeldungen als 
  139.    Texte' eingestellt sein.
  140.    Nun erhalten Sie eine gefilterte Liste, bei der ergo! versucht alle
  141.    Situationen zu finden, in denen Sie Variablen fehlerhaft oder zweifel-
  142.    haft eingesetzt haben. Sie werden vielleicht überrascht sein, wieviel 
  143.    'Müll' sich im Laufe der Zeit in Ihrem Programm angesammelt hat. Auch 
  144.    lassen sich manche Tippfehler in Variablennamen damit finden.  Viele 
  145.    Sachen werden aufgedeckt, die - wenn überhaupt - nur mit stundenlanger 
  146.    mühevoller Suche zu finden gewesen wären.
  147.  
  148. Experimentieren Sie nun mit den Einstellungen im XRef-Ausgabe-Dialog, um 
  149. herauszufinden, wie vielfältig Sie die Ausgabe und Auswertung steuern 
  150. können. 
  151. HINWEIS: In der Demo-Version werden nur die Variablen mit den Anfangsbuch-
  152. staben 'a' - 'k' ausgegeben.
  153.  
  154.    
  155. 7. Die ONLINE-Analyse
  156. ---------------------
  157. Neben der Listen-Ausgabe der Analyse haben Sie auch direkten Zugriff auf 
  158. einzelne Informationen. Haben Sie noch die GFA-Datei mit der gerade erzeug-
  159. ten XRB-Datei im Projektfenster eingestellt?   Dann gehen Sie nun in den 
  160. Interpreter (Taste 'G') und stellen den Cursor auf den Namen einer Prozedur
  161. oder Variablen. Nun rufen Sie das Help-ACC auf und siehe da .... die Verweis-
  162. liste zum betreffenden Namen erscheint im Fenster! Zwei Dinge sind hieran zu 
  163. sehen: 1. Das ACC erlaubt auch den Zugriff auf die XRef-Analyse und 
  164.        2. funktioniert auch hier die Kommunikation mit dem Interpreter. 
  165. Für weitere Abfragen geben Sie einfach den Namen der Variablen ein. 
  166. 'Wo eingeben?', na tippen Sie einfach los, es erscheint dann sofort die 
  167. Eingabebox. Es genügt auch der Anfang des Namens, gefolgt von einem Stern. 
  168. Die Wildcars '*' und '?' funktionieren dabei wie gewohnt und können sogar 
  169. auch mehrfach eingesetzt werden. Hängen Sie ein großes 'D' an das Suchmuster, 
  170. dann erhalten Sie die 'Diagnosemeldungen' zu den Namen. Aber halt, die Abfra-
  171. gemöglichkeiten sind ja im ACC auf eigenen Help-Screens ausführlich erklärt. 
  172. Und dank  der Beispiele bleibt keine Frage offen. Mit ESC kann übrigens jeder-
  173. zeit in den GFA-Modus und zurückgeschaltet werden. 
  174.  
  175. Direkter Zugriff auf die XRef, sogar aus dem Interpreter heraus, bequemer 
  176. geht's nicht! Oder etwa doch?? Dann probieren Sie mal den 'Informer': 
  177.  
  178.  
  179. 8. Der Informer
  180. ---------------
  181. Sind Sie nun wieder in der Shell? Ok, dann geht's weiter: mit 'Bearbeiten -- 
  182. Informer' erscheint ein Dialog, der folgendermaßen eingestellt sein sollte: 
  183. 'Hinweise einfügen', 'in alle Prozeduren' und alle vier Kreuze gesetzt. 
  184. Mit 'OK' geht's los. Im Ablauffenster sehen Sie, daß eine Datei erzeugt wird, 
  185. die fast wie Ihre original GFA-Datei heißt, nur daß sie eine Schlange (~) im 
  186. Namen hat. Wenn alles fertig ist, sehen Sie im Projektfenster, daß der Knopf
  187. [ ~.GFA ] schwarz ist. Auch er besagt, daß die zugehörige 'Schlange-Datei' 
  188. erzeugt worden ist. Laden Sie diese nun in den Interpreter, indem Sie mit 
  189. der Maus auf den besagten Knopf klicken. Haben Sie's? Dann schauen Sie mal 
  190. in die Prozeduren hinein.. und, was sehen Sie? Die XRef-Informationen zu allen
  191. Prozeduren fein säuberlich eingetragen. hierfür müssen Sie also nicht einmal 
  192. mehr in das Help-ACC gehen! Nun geht's also wirklich nicht mehr bequemer!! 
  193. Ach ja, wenn Sie mit dieser Datei weiterarbeiten wollen, so müssen Sie diese 
  194. natürlich wieder unter dem Originalnamen abspeichern.
  195.  
  196.  
  197. 9. Der Präpozessor
  198. -------------------
  199. Für effektive Programmierung unerläßlich und bislang nur den C-Programmierern 
  200. vorbehalten: Der Präprozessor! Was er macht und wie er funtioniert?? Naja, 
  201. was soll hier alles nochmal hingeschrieben werden, das sowieso schon in den 
  202. Hilfstexten steht? Rufen Sie den Präprozessor-Dialog auf und studieren Sie die
  203. Hilfen zu allen Punkten, dann dürften keine Fragen mehr offen bleiben. 
  204.  
  205.   (WIEBITTE..??..Sie wissen nicht, wie man an die Hilfen kommt? Haben Sie nicht
  206.   den Punkt (4) weiter oben gelesen?? Na dann aber ganz schnell!.....Na 
  207.   sehen sie, es ist doch ganz einfach: Shift-Klick auf irgendeinen Text, 
  208.   und schon sind Sie im Bilde!! Aber jetzt wieder zurück zu Thema..)
  209.  
  210. Der große Vorteil des ergo!-Präprozessors: Er verarbeitet direkt die GFA-Datei 
  211. und ist daher affig schnell! (Abgesehen von der künstlichen Demo-Bremse). Und: 
  212. Er kann mit dem Compiler und Linker zu der vollautomatischen 'Extended-Make-
  213. Funktion' zusammengeschaltet werden. Aber die ist leider in der Demo-Version 
  214. gesperrt. Aber ahnen Sie bereits, wie komfortabel Sie in Zukunft Ihre Projekte 
  215. erstellen können?
  216. Übrigens: Natürlich ist auch diese Demoversion auf Knopfdruck mit der 'Extended-
  217. Make-Funktion' erzeugt worden. 
  218. Im Ordner \BEISPIEL finden Sie ein kurzes Listing, das die Anwendung der 
  219. Präprozessorbefehle demonstriert.
  220.  
  221. 10. Ein Projekt definieren
  222. --------------------------
  223. Ihr 'Projekt' besteht bisher nur aus dem Namen von GFA-Datei und erzeugter 
  224. Programmdatei sowie den zugehörigen Compiler- und Linkereinstellungen. 
  225. Diese werden mit 'Datei -- PRJ sichern' (oder ^S) abgespeichert und 
  226. können über 'Datei -- PRJ öffnen' wieder geladen werden. Bis zu 10 Projekte
  227. sind übrigens direkt abrufbar. Klicken Sie mal mit der rechten Maustaste...
  228. schon erscheint das Projektauswahlfenster. Hier können Sie die zehn meist-
  229. geladenen Projekte fest ablegen und mit Tastendruck abrufen und bearbeiten.
  230.  
  231. Natürlich kann so ein Projekt noch mehr entalten. Wie Sie sehen, sind die
  232. sechs mittleren Felder des Projektfensters noch unbelegt. Das werden wir nun
  233. ändern: Benutzen Sie RSC-Dateien? Dann tragen Sie die zugehörige RSC-Datei
  234. in eines der Felder ein (wie gewohnt per Doppelklick).  Doch was nützt diese
  235. ohne ein `Resource-Constuction-Set'? Rufen Sie daher 'Parameter --Zugriffspfade'
  236. auf und tragen hier Ihr RCS (Interface, ORCS, RCS2,...) ein. Wichtig: Gleich
  237. den Extender 'RSC' mit eintragen (in das Feld rechts von der Datei). 
  238. So, nun wieder zurück zum Projektfenster und einen Einfachklick auf den 
  239. RSC-Eintrag durhcgeführt... und schon ist das RCS gestartet und die RSC-Datei 
  240. geladen. 
  241.  
  242. Das war nun das Grundmuster. Nach demselben Schema können Sie nun z.B. Texte 
  243. eintragen und einen Editor oder ein Schreibprogramm dazu anmelden. Oder
  244. Bilddaten eintragen und ein Malprogramm anmelden. Oder sogar weitere GFA-
  245. Programme (der Interpreter ist ja bereits angemeldet). Oder, oder, oder... 
  246. Wichtig nur: Für eine reibungslose Zusammenarbeit müssen die passenden Extender
  247. angemeldet sein! So können Sie die Daten mit Mausklick aufrufen. 
  248.  
  249. Da einige der angemeldeten Programme nicht für ein einziges, sondern für alle
  250. Projekte gelten sollen, unterscheidet die Shell zwischen allgemeinen und pro-
  251. jektgebundenen Programmen. Näheres sehen Sie im 'Zugriffspfade'-Dialog.
  252.  
  253.  
  254.                     
  255. Und was noch ??
  256. ---------------
  257. Nachdem nun der Schnelldurchgang beendet ist, werden Sie die anderen Möglich-
  258. keiten und Funktionen von ERGO!-pro bestimmt selbst auskundschaften können. 
  259.  
  260.  
  261.  
  262. Viel Spaß beim Probieren wünschen die ERGO!pro-grammierer
  263.                                         
  264. Gregor Duchalski und Christof Schardt
  265.  
  266.